home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / egames__ / hinthunt.zip / HINTHUNT.DOC < prev    next >
Text File  |  1994-03-06  |  18KB  |  319 lines

  1.  
  2.  
  3.  
  4.                                 HINT-HUNT (TM)
  5.                                 Copyright 1994
  6.                         Castle Oaks Computer Services
  7.                             Post Office Box 36082
  8.                          Indianapolis, IN 46236-0082
  9.                                 (317) 823-6366
  10.  
  11. HINT-HUNT (TM) is a word search puzzle generator.  It is a special type of 
  12. puzzle generator which has been designed for use by teachers. Its purpose is 
  13. to provide a tool for making homework assignments that students will enjoy 
  14. doing. 
  15.  
  16. Although it can create ordinary word search puzzles, its main purpose is to 
  17. produce a puzzle where the word list contains a set of hints that correspond 
  18. (in a one-to-one fashion) to a different set of words that are inserted into 
  19. the puzzle. This program was developed so that puzzles can be made where the 
  20. puzzle words are in one language and the corresponding hints in the word list 
  21. (hints) are in a different language. However, the program is not limited to 
  22. just the above use. Since you have the capability of putting one set of words 
  23. in the puzzle and a different set of words in the word list, the word list can 
  24. have hints that relate to the words in the puzzle. Therefore, the program can 
  25. be used in many disciplines other than language. (Any characters including 
  26. spaces may be placed in the list of hints; see the note at the end of this 
  27. document concerning accented characters) 
  28.  
  29. HINT-HUNT (TM) is a commercial program. (A shareware version has been released 
  30. for trial use. It may be used for up to 30 days.)  After the trial period, if 
  31. you wish to continue use of the program, you must purchase the commercial 
  32. version for $15.00. (Send your payment to the above address.) Upon receipt of 
  33. your payment, you will be sent the latest version of the program and you will 
  34. be notified of any upgrades and other products available from Castle Oaks. 
  35. Since this program was developed for educational use, a school or a school 
  36. system may buy a site license. Contact Castle Oaks for site license pricing.
  37.  
  38. You may create puzzles which you produce for publication.  If you publish a 
  39. puzzle, registration is required and a royalty is payable in some cases.  
  40.  
  41. The following rules must be followed in such cases:
  42.  
  43.      1.  Puzzles must be in good taste as judged by the mores of the
  44.          general population.
  45.  
  46.      2.  The puzzle must display the trademark and its owner, Castle Oaks
  47.          Computer Services.
  48.  
  49.      3.  In some cases, a royalty payment is required for published 
  50.          puzzles. If you have purchased the program for say a church or 
  51.          a school, then you may publish puzzles in your newsletter or 
  52.          for use in class without royalty. If you submit a puzzle for 
  53.          more general distribution, then a royalty must be paid for each 
  54.          puzzle published. The fee is $5.00 or 15% of the amount received 
  55.          for the puzzle, whichever is greater.
  56.  
  57.      4.  A copy of the puzzle being published must be sent to Castle Oaks 
  58.          along with the royalty payment. Also include the name and date 
  59.          of the publication in which it will appear.
  60.  
  61. Failure to abide by the above rules will lead to legal action.
  62.  
  63.  
  64.                                     USAGE
  65.  
  66. HINT-HUNT (TM) is easy and fun to use. It is great for creating puzzles for 
  67. educational use.  Or you might want to use it for entertainment at a party.  
  68. You can make up puzzles containing the names, interests, etc. of persons 
  69. attending the party. The only installation required is to copy the executable 
  70. file (HINTHUNT.EXE) to a directory or disk of your choice. The command line to 
  71. execute the program has the general form:
  72.  
  73. HINTHUNT [P|S] [M]
  74.  
  75. The command line options in brackets are optional (do not include the brack-
  76. ets.) They may be upper or lower case and the order may be the reverse of that 
  77. shown. P|S means that you may enter either P or S. P means you want to create 
  78. a primary level puzzle, and S means you want to create a secondary level 
  79. puzzle (these are explained in the description of the menu). If you do not 
  80. enter either, a puzzle will be created at the highest level. You may omit both 
  81. of these parameters on the command line and still select primary or secondary 
  82. from the menu. The M option tells HINTHUNT to run in monochrome mode. If you 
  83. only have a monochrome display (such as an LCD screen) you will need to use 
  84. the M option.
  85.  
  86. You can run the program from a floppy disk by including the drive letter on 
  87. the command line. There are certain requirements and restrictions.
  88.  
  89.      a.  You must have a printer and it must be turned on, on-line and the          
  90.          paper should be positioned at top-of-form. Your printer must be 
  91.          capable of backspacing. If it does not have that capability, some 
  92.          lines in the solution printout may not be correct. The solution 
  93.          will probably look best when printed in draft mode. You should 
  94.          experiment with number of characters per inch and number of lines 
  95.          per inch on your printer to achieve the most pleasing printout. 
  96.          In order to show the connections between words, it was necessary 
  97.          to add extra lines in the solution. This was done so that the 
  98.          solution could be displayed on most printers; therefore the aspect 
  99.          ratio of the solution will be different from that of the puzzle.  
  100.  
  101.          (Actually the program may be run without the printer. When asked 
  102.          for number of copies to be printed you may respond with zero. 
  103.          However, the program is not very useful without hard copy output 
  104.          unless you have saved the puzzle and/or solution to file for later 
  105.          printing.)
  106.  
  107.      b.  Your puzzle can have dimensions of up to 40 by 40. In most cases, 
  108.          much smaller puzzles, 20 by 20 or smaller, are quite satisfactory. 
  109.          (Note: Dimensions are to be given in columns and lines.) Your 
  110.          puzzle can have as many as 100 words. Usually 25 words is adequate.
  111.  
  112. The program starts by asking you to press 'M' (or 'm') to see the option menu 
  113. or any other key to go directly to building the puzzle. During this time, the 
  114. program is developing a seed (starting value) for the random number generator. 
  115. If you press an 'M', the program displays a menu of nine options. They are:
  116.  
  117.  
  118.           1 Primary puzzle
  119.           2 Secondary puzzle
  120.           3 Ordinary word search puzzle (one word list)
  121.           4 Ordinary puzzle and encrypt the word list
  122.           5 43 line mode
  123.           6 Provide seed for random number generator
  124.           7 Hints to be printed one per line
  125.           8 Provide delay time for puzzle display (Default = 500 milliseconds)
  126.           9 Exit menu
  127.  
  128. If you choose option 1 (or if you have entered a 'P' on the command line), the 
  129. program will make a puzzle that inserts the words only in the left-to-right 
  130. and downwards directions (this is called a primary puzzle). When you select 
  131. option 1, the menu entry turns to red (bright white in monochrome mode) which 
  132. means that the option has been selected. It also de-letes option 2 from the 
  133. menu so it cannot be selected.
  134.  
  135. If you choose option 2 (or if you have entered a 'S' on the command line), the 
  136. program will make a puzzle that inserts the words in the two directions of 
  137. option 1 but also in the two left-to-right diagonal directions (this is called 
  138. a secondary puzzle). The menu line turns to red and option 1 is deleted from 
  139. the menu.
  140.  
  141. If you do not choose either option 1 or 2, the program will make a puzzle 
  142. inserting words in eight different directions.
  143.  
  144. If you choose option 3, the program will use the same list of words for the 
  145. puzzle and the word list (hints). This provides you with the capability to 
  146. make ordinary word search puzzles. (You can also make an ordinary puzzle by 
  147. placing the same word for a hint as you enter for the puzzle.) Ordinary puz-
  148. zles are suitable for making a puzzle of spelling words. When you choose 
  149. option 3, the menu line is displayed in red to show that you have selected it. 
  150. (Remember, if you are entering the words from a file, there must be only one 
  151. word on each line of the file. (If you do not select option 3 or 4, and you 
  152. input from a file, each line of the file must contain a word, followed by a 
  153. hint to be entered in the word list.)
  154.  
  155. If you choose option 4, it also automatically selects option 3 also. Both menu 
  156. lines 3 and 4 will be displayed in red. Option 4 also tells the program to 
  157. encrypt the word list. (Option 3 is selected because if the puzzle were not 
  158. the ordinary type, the word list might contain characters other than upper 
  159. case alphabetic and it would be difficult to select a suitable encryption 
  160. technique for them.)
  161.  
  162. Option 5 allows you to put your display in 43 line mode if you have an EGA or 
  163. better display. Normally you will not need to do this unless you are creating 
  164. a puzzle that is longer than 20 lines. If selected, line 5 of the menu will be 
  165. displayed in red.
  166.  
  167. Option 6 provides a means to defeat the automatic creation of the seed for the 
  168. random number generator. At the beginning of the program, a seed was deter-
  169. mined by the amount of time it took you to press any key. If you select option 
  170. 6, the number that was previously determined will be discarded and a number 
  171. that you enter will be used. The number must be in the range 1 through 32767. 
  172. Selecting your own seed provides you with a method of duplicating a previously 
  173. made puzzle. If both puzzles use the same seed and the same word list and same 
  174. dimensions, the puzzles will be the same.
  175.  
  176.  
  177. Option 7 Provides the user with the capability to change the way that the 
  178. hints are printed with the puzzle. If you choose this option, the hints are 
  179. printed one per line with adequate space at the left for a student to enter 
  180. the answer. A teacher requested this capability so that when a puzzle is used 
  181. for homework, it will be easy to grade the answers.
  182.  
  183. Option 8 provides you the capability to slow down the display of the puzzle as 
  184. it is built. The default value is 500 milliseconds (one-half second.) You are 
  185. to enter the desired delay time in an integral number of milliseconds.
  186.  
  187. Option 9 Exits the menu and starts the puzzle building process. 
  188. (Actually,pressing any key other than 1 through 8 will cause the program to 
  189. exit the menu and start building the puzzle.)
  190.  
  191. On-screen prompts are provided to guide you through the process. You are first 
  192. asked for the width (in columns) and the length (in lines). Then you are asked 
  193. for a title for the puzzle. This title may not exceed 77 characters. You may 
  194. want to include in the title some directions. For example:
  195.  
  196.           FIND THE ENGLISH WORDS FOR THE FRENCH WORDS IN THE LIST 
  197.  
  198. (If you need more than 77 characters, you can save the puzzle to a file after 
  199. it has been made and then using an editor, you can add as much text as you 
  200. wish.)
  201.  
  202. You are then asked if you want to input the words from a file or from the 
  203. keyboard. If you input from a file, the file should either be one that was 
  204. saved earlier from within the program or it may be one you have created sepa-
  205. rately using an editor. In the latter case, the file must be constructed in 
  206. the correct format. If the file is to be input for an ordinary word search 
  207. puzzle, each line must contain a single word followed by a carriage return and 
  208. a line feed. If the file is to contain two word lists, each line of the file 
  209. must contain a single word for the puzzle followed by a space and then an 
  210. entry for the word list (hints) followed by a carriage return and a line feed. 
  211. The entry for the puzzle must contain only alphabetic characters and no 
  212. spaces. (See the note at the end of this document for exceptions.) The entry 
  213. for the word list may contain any characters including spaces. 
  214.  
  215. If you choose to enter words from the keyboard, you will be prompted appro-
  216. priately to obtain your list(s). When you are prompted for a word to be en-
  217. tered in the puzzle, the display will show a box whose length is the lesser of 
  218. the width and length of the puzzle. If you try to enter more characters than 
  219. the space provided, the program will not accept any extra characters. Like-
  220. wise, when you are prompted for a hint, a box will be displayed that goes all 
  221. the way to the right margin of the screen. This indicates the amount of space 
  222. allowed for a hint. If you try to enter more characters than allowed, they 
  223. will not be accepted. When finished with entering words, just press ENTER 
  224. (when prompted for a new word) to terminate the process. 
  225.  
  226. After entering your words, either from a file or the keyboard, the words will 
  227. be displayed and you will be given the option of changing any one of the 
  228. entries. If the number you enter is negative, and if its absolute value is in 
  229. the range 1 through the highest entry number, the corresponding entry will be 
  230. deleted and the range will be reduced by one. If you enter a number whose 
  231. absolute value is not in the range 1 through the highest entry number, you 
  232. will be prompted that the number is out of range; and given the option of 
  233. adding an entry or not. If you answer "yes", you will be prompted for a new 
  234. entry and it will be added as the next one, no matter what value you entered. 
  235.  
  236.  
  237. If you respond "no" and the number you entered was positive you are asked to 
  238. input the number of the entry you want to change. If you respond "no", and the 
  239. number you entered was negative, you will be asked if you want to change an 
  240. entry. After making changes, if any, the program will build the puzzle.
  241.  
  242. If you have entered the words from the keyboard, or if you have entered them 
  243. from a file and changed one or more words, the program will ask if you want to 
  244. save the words to a file. If you save the words, the file will be in suitable 
  245. form to be read by the program at some other time. 
  246.  
  247. As the puzzle is built, the program will display each word as it attempts to 
  248. insert it. If the program cannot insert a word, you will be alerted (in the 
  249. bottom border) and given the option of starting over (in the hope that a new 
  250. try will allow the word to be inserted) or discarding the word. If you elect 
  251. to start over, you will also be given the option of increasing both the width 
  252. and length of the puzzle by one unit. People have the tendency to try to make 
  253. puzzles as small as possible. This not only makes it difficult to place all of 
  254. the words, it also leads to puzzles where many words are placed side by side 
  255. in very few different directions. Larger puzzle sizes result in puzzles with a 
  256. better distribution of directions of insertion.
  257.  
  258. It may be difficult to evaluate the esthetics of the puzzle from the screen 
  259. display. Therefore, you are given the option of printing the puzzle solution 
  260. which shows how the words have been laid into the puzzle. You may then contin-
  261. ue, have the program re-position the words or abort the program.
  262.  
  263. When you continue, you will be given the opportunity of saving the puzzle and 
  264. solution to file and you can specify the number of copies that you want to 
  265. have printed. (CAUTION! When asked to respond with a Y or N, do not follow 
  266. that response with pressing ENTER. It is not necessary and will be interpreted 
  267. as a null response to the next prompt.) In general, you only terminate a 
  268. response with an ENTER when you input a string of characters or a number.
  269.  
  270. Two special features are included for avoiding situations that might be unde-
  271. sirable. For example, you may want to enter the two words, "BACKROOM" and 
  272. "ROOMMATE". If you do, there is the possibility that they will share all the 
  273. letters of "ROOM". You may like that or you may not, if not, just prefix 
  274. "ROOMMATE" with an 'X'. The 'X' will not be printed in the puzzle or the word 
  275. list. This means that no words can begin with a single letter 'X'. If you want 
  276. a word to begin with an 'X', just prefix it with another 'X' which will be 
  277. purged from the word list. Another example where you would be more likely to 
  278. use this feature is when one word would be contained entirely in another word. 
  279. "VIRGINIA" and WESTVIRGINIA" or "THE" and "EITHER". In such cases, just prefix 
  280. the shorter word with an 'X'. Also, note that a word might be contained en-
  281. tirely in another one but in reverse order; example: "TEN" and "NINETEEN". You 
  282. may want to allow that; but if you don't, prefix the "TEN" with an 'X'.
  283.  
  284. The above doesn't take care of the cases where the shorter word is entirely 
  285. contained at the beginning of the longer word. Example: "ROOM" and "ROOM-
  286. MATE". If you do not want these words to share the letters "ROOM", add a 'Q' 
  287. to the end of the shorter word. In the rare instance where a word naturally 
  288. ends in 'Q', add a second 'Q' and it will be discarded instead of the real 
  289. 'Q'. Note that this artifice could be used in all of the above examples except 
  290. where the shorter word is at the end of the longer word as in "VIRGINIA" and 
  291. "WESTVIRGINIA".
  292.  
  293. NOTE - Using accented characters
  294.  
  295. Normally, when you enter a word that is to be placed in the puzzle, any lower 
  296. case letters are converted to upper case and any other characters are not 
  297. accepted. To provide some foreign language capability, all of the accented 
  298. characters listed below are allowed also.
  299.  
  300. The hints may contain any characters, including accented characters. You may 
  301. enter an accented character by holding down the "Alt" key while entering the 
  302. character's decimal code on the numeric keypad. When you release "Alt", the 
  303. character will appear in the word. The codes for the accented characters are:
  304.  
  305.      Ä 142; Å 143; â 131; ä 132; à 133; å 134; á 160; 
  306.  
  307.      Æ 146; æ 145; 
  308.  
  309.      Ç 128; ç 135; 
  310.  
  311.      É 144; ê 136; ë 137; è 138; é 130; 
  312.  
  313.      î 140; ï 139; ì 141; í 161; 
  314.  
  315.      Ñ 165; ñ 164; 
  316.  
  317.      Ö 153; ô 147; ö 148; ò 149; ó 162; 
  318.  
  319.